home *** CD-ROM | disk | FTP | other *** search
/ Turnbull China Bikeride / Turnbull China Bikeride - Disc 2.iso / BARNET / ARMTEX / LF210 / !LongFiles / !Help next >
Text File  |  1999-01-31  |  23KB  |  585 lines
  1. LongFiles 2 © Jason Tribbeck 1997/8
  2. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  3. This is LongFiles 2. It is a total rewrite of LongFiles, written in C, as
  4. opposed to assembler. Although this makes the code larger, it is much more
  5. maintainable and bugs should be easy to fix.
  6.  
  7. This !Help contains some of the !Help for version 0.10 (which is the same as
  8. 0.11)
  9.  
  10. ############################################################################
  11. ##                                                                        ##
  12. ## ---------------------=======< NEWS FLASH >=======--------------------- ##
  13. ##                                                                        ##
  14. ## As of version (0.08), !LongFiles has become fully PD, on the condition ##
  15. ## that the copyright remains with the author, and this !Help file is     ##
  16. ## included in full.                                                      ##
  17. ##                                                                        ##
  18. ## The author has no undertaking to provide support for !LongFiles, but   ##
  19. ## may be able to provide help if asked in a nice way, and if he has had  ##
  20. ## a good day :-)                                                         ##
  21. ##                                                                        ##
  22. ## LongFilenames is (C) Jason Tribbeck/7th ARM Systems 1994. All rights   ##
  23. ## reserved.                                                              ##
  24. ##                                                                        ##
  25. ############################################################################
  26.  
  27.   LongFiles 2 is (C) Jason Tribbeck/ARM Designs 1998. All rights reserved.
  28.  
  29. Major differences between 0.11 and 2.00+
  30.  
  31. + Completely rewritten in C;
  32. + FrontEnd makes it much easier to configure LongFiles and also add filing
  33.   systems to it;
  34. + Different file structure - allows upto 32767 long filenames, and 255
  35.   character filenames;
  36. + Stores first 6 characters of 'real' filename to aid recognition when not
  37.   using LongFiles
  38.  
  39. ------------------------------  How it works  -------------------------------
  40.  
  41. If any filenames longer than 10 characters are used, it will store them under
  42. a special filename. Several operating system routines are claimed, which
  43. enable these translations to occur. The special names are the first six
  44. characters of the long filename, followed by a "}", and then a special three
  45. digit code for the file.
  46.  
  47. For example, the first long filename is "ThisIsALongName". It will be stored
  48. as "ThisIs}000". If you were to add another filename of "SomeOtherLongName",
  49. then this would be "SomeOt}001". If you were to add a further long filename
  50. of "ThisIsAnotherLongName", then it would be "ThisIs}002".
  51.  
  52. Note that in the desktop, and also the command line, you would not see this
  53. occuring - LongFiles maintains the names when cataloguing, until LongFiles
  54. has been disabled from the filing system.
  55.  
  56. To do all of this, LongFiles claims parts of the filing system structure,
  57. notably to do with creating, accessing, and listing files. This is performed
  58. using either the FrontEnd, using *Commands, or using the SWI calls.
  59.  
  60. Once claimed, any filename longer than 10 characters is processed, with the
  61. resultant filename (only composing of short filenames) being passed to the
  62. filing system.
  63.  
  64. If you decide that you don't need to use LongFiles any more, filing systems
  65. can be released back to their normal operation - note that this is not
  66. updated in the Filer windows, so they will show their LongFile states. Once
  67. you re-open the windows, they will become updated.
  68.  
  69. If you do this on a directory which has a long filename in it, you will also
  70. notice another file called "!ZZ!!Z!!LF". This special file contains the data
  71. for all the long filenames in a directory. This file is hidden during normal
  72. LongFiles operation, but once the filing system has been released, it can be
  73. viewed, edited or copied. DO NOT MODIFY OR DELETE THIS FILE - LONGFILES MAY
  74. GET VERY CONFUSED!
  75.   
  76. ---------------------------  Using the FrontEnd  ----------------------------
  77.  
  78. When you run !LongFiles, an icon will appear on the right hand side of the
  79. iconbar. This is the LongFiles icon. The only thing you can do with it is
  80. press MENU. This will produce a menu:
  81.  
  82. Info            ->
  83. Filing system   ->
  84. Save defaults
  85. Icon by default
  86. ------------------
  87. Quit            ->
  88.  
  89. Moving to the right of "Info" will show you the version number of the
  90. FrontEnd, the creation date and the build number.
  91.  
  92. Moving to the right of "Filing system" will show you all the filing systems
  93. you were running when you ran !LongFiles. If you are not of a technical
  94. persuasion, then there are a lot more than you would have thought! Any that
  95. are ticked have been 'claimed' by LongFiles. If you select a filing system,
  96. then that filing system will be claimed. You should only claim the FileCore
  97. filing systems. A list of the common ones are as follows:
  98.  
  99. RAM
  100. ADFS
  101. SCSI
  102. IDEFS
  103. IZipFS
  104. ATAFS
  105.  
  106. You should not share any filing system except these - but there is nothing
  107. stopping you from doing so!
  108.  
  109. Note that if you have a 'dynamic' filing system, such as IZipFS (ie. you can
  110. quit it and restart it when you want), then the FrontEnd will only recognise
  111. it if you ran the FrontEnd while the filing system was running.
  112.  
  113. Clicking on "Save defaults" will cause all the filing systems ticked to be
  114. automatically claimed by LongFiles the next time you run it. This makes it
  115. easy to configure what filing systems to use for LongFiles, and you also do
  116. not need to use the *commands, if you have used earlier versions.
  117.  
  118. If you disable "Icon by default", then the icon will not be displayed. If you
  119. want the icon to be shown, then press ALT while loading the front-end.
  120.  
  121. Clicking on "Quit" quits the FrontEnd, NOT LongFiles itself. However, if you
  122. do want to quit LongFiles as well, move to the right, and select "Quit
  123. LongFiles as well".
  124.  
  125. --------------------------------  *Commands  --------------------------------
  126.  
  127. There are currently four *commands:
  128.  
  129. AddLongFS
  130. ~~~~~~~~~
  131. Syntax:
  132.  
  133. *AddLongFS <fsname>
  134.  
  135. This adds a filing system to LongFilenames' list. <fsname> is just the filing
  136. system name, with no spaces afterwards.
  137.  
  138. Example:
  139.  
  140. *AddLongFS ADFS
  141.  
  142. AddNoCacheLongFS
  143. ~~~~~~~~~~~~~~~~
  144. Syntax:
  145.  
  146. *AddNoCacheLongFS <fsname>
  147.  
  148. This is exactly the same as *AddLongFS; it is included because it treated
  149. filing systems differently under 0.11.
  150.  
  151. Example:
  152.  
  153. *AddLongFS ADFS
  154.  
  155. RemoveLongFS
  156. ~~~~~~~~~~~~
  157. Syntax:
  158.  
  159. *RemoveLongFS <fsname>
  160.  
  161. This is the opposite of *AddLongFS. LongFilenames will detach itself from the
  162. filing system.
  163.  
  164. Example:
  165.  
  166. *RemoveLongFS RAM
  167.  
  168. LongFSList
  169. ~~~~~~~~~~
  170. Syntax:
  171.  
  172. *LongFSList
  173.  
  174. This lists all the filing systems currently 'claimed' by LongFiles, along
  175. with the filing system numbers, their special filename, their split
  176. character and the maximum filename.
  177.  
  178. Example:
  179.  
  180. *LongFSList
  181. RAM (23) - !ZZ!!Z!!LF } 10
  182. ADFS (8) - !ZZ!!Z!!LF } 10
  183. SCSI (26) - !ZZ!!Z!!LF } 10
  184.  
  185. SpecialLongFS
  186. ~~~~~~~~~~~~~
  187. Syntax:
  188.  
  189. *SpecialLongFS <fsname> <special file> <split character>
  190.  
  191. This allows you to override the default special filename and default split
  192. character. By default, the special filename is "!ZZ!Z!!LF" (which is used to
  193. store the long filenames), and the split filename is "{". By using this
  194. command, LongFiles can use other filenames/characters, so it can be used, for
  195. example, with OmniClient.
  196.  
  197. Example:
  198.  
  199. *SpecialLongFS NFS __LF__NAM (
  200.  
  201. This says that NFS will use "__LF__NAM" to store the long filenames, and "("
  202. as the split character.
  203.  
  204. If you want to use it with CDFS, the following standard MUST be adhered to,
  205. as it may be possible for several CD software producers to use LongFiles:
  206.  
  207. *SpecialLongFS CDFS LONG__FS /
  208.  
  209. This means that "LONG__FS" and "/" are used.
  210.  
  211. *SetFSMaxLength
  212. ~~~~~~~~~~~~~~~
  213. Syntax:
  214.  
  215. *SetFSMaxLength <fsname> <characters>
  216.  
  217. This is used to set the maximum number of characters when checking if a file
  218. exists or not. Normally, this is 10, but for CDFS it is 12 (since the file
  219. "README11/TXT" is 12 characters long and legal).
  220.  
  221. Example:
  222.  
  223. *SetFSMaxLength CDFS 12
  224.  
  225. Debugging
  226. ~~~~~~~~~
  227. If you have a debugging version, then the following will be available:
  228.  
  229. *LongFiles_Log <log_size> <log_level> <filename_to_log>
  230. *LongFiles_NoLog
  231.  
  232. *LongFiles_Log enables logging to a file.
  233.  
  234. The file is stored in memory until *LongFiles_NoLog is called. NO CHECKS ARE
  235. PERFORMED AT THIS STAGE TO ENSURE THE FILE IS WRITEABLE.
  236.  
  237. The memory size used is given as the log_size, which is measured in KBytes,
  238. so if you use the value 100, then 100K is used.
  239.  
  240. The log level ranges from 0 (minimal level) to 10 (maximum level). A higher
  241. log level increases the amount of log data, whereas a lower value decreases
  242. it. If you are doing logging over a long period, it is best to use a high
  243. value (>1000) to capture all the data. A 24 second "Count" on 662 files with
  244. "Faster" enabled consumed 153K, for example.
  245.  
  246. *LongFiles_NoLog turns off logging, and writes the log file.
  247.  
  248. --------------------------  The SWI interface  ------------------------------
  249.  
  250. This information will not be covered in great detail here - when LongFiles
  251. has settled down, it will form an integral part of my FileSuite, which shall
  252. include:
  253.  
  254. LongDirs
  255.  - More than 77 entries per directory;
  256.  - This is working kindof, and can be alpha tested upon request (limited
  257.    numbers, though);
  258. ShortFiles
  259.  - Background compression of data;
  260. HideFiles
  261.  - Hide files from being viewed in *cat, *ex and also desktop operation;
  262.  - A very cut-down "see-if-it-works" version has been used for about 8 months
  263.    on ArgoNet's stand to protect data;
  264. LockFiles
  265.  - Much more thorough locking system than *Access;
  266.  
  267. And some others I can't remember at the moment, but it sounded like fun at
  268. the time!
  269.  
  270. Since LongFiles will form an integrated part of the FileSuite, here are the
  271. SWI calls for completeness. If you want to use them in your program, call
  272. LongFiles_Version to find out the version number. The SWI interface may
  273. change in later versions, but this will be indicated by the version number
  274. moving on to 3.xx. If you get an error while calling this SWI, you can assume
  275. that the version number is less than 2.08
  276.  
  277. LongFiles_AddFS (0x4e3c0)
  278. ~~~~~~~~~~~~~~~~~~~~~~~~~
  279. Equivalent to *AddLongFS <fsname>
  280.  
  281. On entry:
  282. R0 is pointer to filing system name to add
  283.  
  284. LongFiles_RemoveFS (0x4e3c1)
  285. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  286. Equivalent to *RemoveLongFS <fsname>
  287.  
  288. On entry:
  289. R0 is pointer to filing system name to remove
  290.  
  291. LongFiles_File (0x4e3c2)
  292. ~~~~~~~~~~~~~~~~~~~~~~~~
  293. Internal call - do not use
  294.  
  295. LongFiles_Open (0x4e3c3)
  296. ~~~~~~~~~~~~~~~~~~~~~~~~
  297. Internal call - do not use
  298.  
  299. LongFiles_Func (0x4e3c4)
  300. ~~~~~~~~~~~~~~~~~~~~~~~~
  301. Internal call - do not use
  302.  
  303. LongFiles_EnumerateClaimed (0x4e3c5)
  304. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  305. Enumerates list of filing systems 'claimed' by LongFiles. Extended in 2.08.
  306.  
  307. On entry:
  308. R0 is current slot number (or 0 for first)
  309. R1 is &54504aa9 for extra information (added in 2.08),
  310.  
  311. On exit:
  312. R0 is next slot (or -1 if none left)
  313. R1 is FS number (or -1 if none left)
  314.  
  315. If R1=&54504aa9 on entry:
  316. R2 is pointer to special filename
  317. R3 is split character in bits 0..7, maxlength in bits 8..15 (added in 2.10)
  318. or R2,R3 preserved if R0=-1 on exit
  319.  
  320. Otherwise:
  321. R2,R3 are preserved
  322.  
  323. LongFiles_SpecialLongFS (0x4e3c6)
  324. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  325. This performs the same function as *SpecialLongFS. Introduced into 2.08
  326.  
  327. On entry:
  328. R0 is pointer to FS name
  329. R1 is pointer to special filename
  330. R2 is split character
  331.  
  332. LongFiles_FSInitialise (0x4e3c7)
  333. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  334. This is used internally when an FS is reinitialised. Introduced into 2.09.
  335.  
  336. On entry:
  337. R0 is FS number
  338.  
  339. LongFiles_Version (0x4e3c8)
  340. ~~~~~~~~~~~~~~~~~~~~~~~~~~~
  341. This is used to return the LongFiles version number. Introduced into 2.09.
  342.  
  343. On exit:
  344. R0 is version number multiplied by 100, so for 2.09, 209 is returned.
  345.  
  346. Note:
  347. If you get an error when calling this SWI, you can assume that the version is
  348. prior to 2.09.
  349.  
  350. LongFiles_FSKilled (0x4e3c9)
  351. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  352. This is used internally, and is functionally the same as LongFiles_RemoveFS,
  353. except it marks the filing system as to be re-initialised if the filing
  354. system restarts again.
  355.  
  356. On entry:
  357. R0 is pointer to filing system name to be removed
  358.  
  359. LongFiles_FSMaxLength (0x4e3ca)
  360. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  361. This is the same as *SetFSMaxLength, except it can be used to get the maximum
  362. length.
  363.  
  364. On entry:
  365. R0 is pointer FS name
  366. R1 is length (or 0 to read)
  367.  
  368. On exit:
  369. R1 is old length (or current length if R1=0 on entry)
  370.  
  371. ----------------------  Front-end command-line options  ---------------------
  372.  
  373. The front-end has a number of command-line options available to it:
  374.  
  375. -standalone
  376.  
  377. This will put the front-end into stand-alone mode. It will not initialise
  378. itself to the WIMP, making it suitable for use when booting in the PreDesk
  379. phase. It does, however, read your default filing system selections.
  380.  
  381. -nochoices
  382.  
  383. This will force LongFiles NOT to use the "Choices:" directory to store the
  384. LongFiles filing system selections.
  385.  
  386. By default, LongFiles will use "Choices:JTribbeck.LongFiles" as its defaults
  387. file, unless this option is set, in which case it will use the "Default" file
  388. inside the LongFiles directory. For backward compatibility, LongFiles will
  389. resort to the "Default" file if it cannot find "Choices:JTribbeck.LongFiles".
  390.  
  391. -optionfile <optionfile>
  392.  
  393. This will tell LongFiles to use the given options file instead of either
  394. "Choices:JTribbeck.LongFiles" or "<LongFiles$Dir>.Default". This **should
  395. not** be a long files name, as LongFiles would not know where to search as it
  396. would have not been initialised by that time.
  397.  
  398. ----------------------------  Version changes  ------------------------------
  399.  
  400. Changes in version 2.10
  401. ~~~~~~~~~~~~~~~~~~~~~~~
  402. + Fixed problem where DOS-style CDFS files reported the error 'not found' when
  403.   >10 character filenames were used;
  404. + Added *SetFSMaxLength command for the above;
  405. + Added SWI FSMaxLength for the above;
  406.  
  407. Changes in version 2.09
  408. ~~~~~~~~~~~~~~~~~~~~~~~
  409. + Added SWI LongFiles_FSInitialise to allow filing systems that have been
  410.   removed to be re-claimed when they restart. For example, changing the size
  411.   of the RAM disc causes RamFS to be killed and then restarted. Note that the
  412.   special names are /not/ stored as yet;
  413. + Added SWI LongFiles_FSKilled to complement LongFiles_FSInitialise;
  414. + Added SWI LongFiles_Version to find out the version number;
  415. + Fixed *Help for SpecialLongFS;
  416. + Front-end now stores and restores special filename and split character for
  417.   stored FSses;
  418. + Module defaults CDFS to "LONG__FS" and "/" for the special names (as passed
  419.   into *SpecialLongFS);
  420.  
  421. Changes in version 2.08
  422. ~~~~~~~~~~~~~~~~~~~~~~~
  423. + TB001 is now fixed - LongFiles now deletes the LongFiles 0.xx format file
  424.   before it creates the LongFiles 2 format file. This is slightly dangerous,
  425.   if LongFiles 2 goes wrong while converting, and it cannot fall back to a
  426.   LongFiles 0.xx format file, but it won't do that :-) ;
  427. + You can now set the special filename and the split character used within
  428.   LongFiles on a per-FS basis, using *SpecialLongFS. This allows LongFiles
  429.   to do its own thing on NFS, CDFS, DOSFS and NTFS. Note that this does
  430.   not make it Windoze95, nor RockRidge compatible; it still does its own
  431.   translations;
  432. + LH001 (Lost in History) bug fixed - LongFiles now removes filing systems if
  433.   they die - very useful for RAM and IZipFS filing systems;
  434.  
  435. Changes in version 2.07
  436. ~~~~~~~~~~~~~~~~~~~~~~~
  437. + IR001 (+JT005) should now be fixed - there was two places where the FS
  438.   list was being read, with only one of them fixed beforehand;
  439. + JT006 fixed - Choices$Write is used instead of Choices$Path. Also, if
  440.   the front-end is run with Choices$Write **not** set, then "-nochoices"
  441.   is assumed for the duration.
  442.  
  443. Changes in version 2.06
  444. ~~~~~~~~~~~~~~~~~~~~~~~
  445. + Possible fix to IR001: This is an extension of JT005 - sometimes a weird
  446.   FS would be displayed in the front-end's list of FSses. After modifying
  447.   the code, I haven't seen this again...;
  448. + Added suggestion JF004: There is now a sub-menu off the Quit icon, which
  449.   allows you to kill LongFiles from the front-end;
  450. + The !Help file has been updated in several areas: some of the links have
  451.   been corrected, RB001 has been added, and the information about the
  452.   front-end has been updated;
  453. + Fixed bug SP001: If the last LongFiles item in a directory is deleted using
  454.   *Wipe, then will cause the next item not to be erased. This fix cannot be
  455.   guaranteed to work with all programs, especially those who multi-task as
  456.   they delete. I can do a much better fix, but it will involve keeping zombie
  457.   entries until the directory is deleted, which isn't very satisfacturary.
  458.   The actual problem is to do with what order files are to be deleted in.
  459.   [This was the first bug to be fixed using the Debug version!]
  460.  
  461. Changes in version 2.05
  462. ~~~~~~~~~~~~~~~~~~~~~~~
  463. + Fixed bug NR001: The results from OS_GBPB 11 were being corrupted. This
  464.   could also fix FP003, which is being investigated.
  465. + Added debug code. This is via two *commands which enable/disable logging.
  466. + Fixed bug JF001: This is a follow-on from JT002, except I hadn't added
  467.   enough characters to check for :(
  468. + Added suggestion PN001: You can now put !LongFiles into your !Boot's
  469.   PreDesk directory, and configure it from there. This is different to the
  470.   actual PN001, but provides a much better solution.
  471.  
  472. Changes in version 2.04
  473. ~~~~~~~~~~~~~~~~~~~~~~~
  474. + Fixed bug FP001: The front-end was claiming rather a lot of memory (1860K).
  475.   This has now been reduced to 40K (on a RiscPC);
  476. + Front-end now shows version number of LongFiles module, as well as compile
  477.   number;
  478. + Fixed bug RW001: LongFile'd filing systems were hiding files - killing
  479.   LongFiles showed the files were still there. This may have fixed other
  480.   bugs: MB001 may have been fixed.
  481. + Added suggestion FP002: You can now enable/disable the front-end by ticking
  482.   the "Icon by default" menu on the front-end's menu. If it is ticked
  483.   (default), then the front-end is in action; if it is unticked, then the
  484.   front-end is immediately closed down when all the configured LongFiles
  485.   filing systems have been setup. If you hold 'Alt' while running !LongFiles,
  486.   then the reverse operation takes place, so you can get the front-end back
  487.   if you have disabled it. Comments?
  488.  
  489. Changes in version 2.03
  490. ~~~~~~~~~~~~~~~~~~~~~~~
  491. + Now uses correct SWI chunk - !Help updated;
  492. + First released version;
  493.  
  494. Changes in version 2.02
  495. ~~~~~~~~~~~~~~~~~~~~~~~
  496. + Fixed bug JT001: Renaming a file to a long filename file where a short
  497.   filename exists whose first 10 characters are the same as the long
  498.   filename's - for example, renaming 'abcdefghij' to 'abcdefghijk' would
  499.   fail. This was due to the FS truncating the destination name (LongFiles
  500.   does not translate long filenames if it cannot find an entry for it) when
  501.   it was looking for the destination name to see if it exists. LongFiles now
  502.   reports the non-existience of non-translated files >10 characters in
  503.   OS_File 5 and its variants;
  504. + Fixed bug JT002: Renaming a long filename into another long filename which
  505.   had different character casing (eg. a file 'abcdefghijk' exists, and a
  506.   rename of 'ABCDEFGHIJK' to 'SomeOtherName') would cause a zombie entry in
  507.   the LongFiles table. This would also cause zombie directories to be
  508.   maintained. Also checked code for other places where case may cause
  509.   confusion;
  510. + Fixed bug JT003: LongFilenames can use wild characters such as "*" and
  511.   "?" in rename - FileSwitch does not seem to do the wild-card checking; it
  512.   leaves it up to the filing system;
  513. + Fixed bug JT004: Errors not being reported correctly from FS;
  514. + Fixed bug JT005: Some machines reports a small FS name at the top of the
  515.   FrontEnd's FS list;
  516. + Extension to bug JW000: Converting old LongFiles entries with zombies does
  517.   not create zombie entries in new LongFiles;
  518. + Modified version number of FrontEnd to make it more consistent - after all,
  519.   this is only the first version of FrontEnd!
  520.  
  521. Changes in version 2.01
  522. ~~~~~~~~~~~~~~~~~~~~~~~
  523. + Created !Help, and incorporated 0.11 !Help (with reformatting);
  524. + Fixed bug JW000: Deletion of directories left 'zombie' directories which
  525.   could not be deleted if !LongFiles was running - apparently LongFiles 0.11
  526.   occasionally exhibited such problems;
  527. + Fixed bug JT000: New directories would not choose the ids of the previous
  528.   cached directory. This also fixed a number of potential problems (such as
  529.   not being able to create LongFilenames in some directories) which would not
  530.   have shown up until much later;
  531. + Removed debugging code from FrontEnd;
  532. + Added code to stop multiple copies of the FrontEnd from running;
  533.  
  534. Changes in version 2.00
  535. ~~~~~~~~~~~~~~~~~~~~~~~
  536. + Rewritten in C;
  537. + Added FrontEnd;
  538. + Uses new format;
  539. + Converts from LongFiles format 9 files (0.10 and 0.11) to new format - with
  540.   other formats being added when needed (everyone should be using 0.11);
  541. + SWI interface, as well as *command;
  542. + Module name is now "LongFiles";
  543.  
  544. ---------------------------  Bugs and suggestions  --------------------------
  545.  
  546. If you have any bugs to report, or you have any suggestions, then please view
  547. the LongFiles WWW site - http://www.tribbeck.com/longfiles - there is an FAQ,
  548. as well as the current bug and suggestions. If you don't see your suggestion,
  549. or bug represented there, then please email jason@tribbeck.com.
  550.  
  551. If you are reporting a bug, please state clearly the bug, and also give a
  552. sequence of events that shows how the bug occuring. For example, the zombie
  553. bug in 2.00 (which was fixed in 2.01) can be repeated:
  554.  
  555. 1. Create a long filenamed directory;
  556. 2. Create two short filenamed directories and one long filenamed directory
  557.    inside this;
  558. 3. Delete the first long filenamed directory;
  559. 4. The long filenamed directory is still present, where it should be deleted.
  560.  
  561. In addition, please put the name of the filing system which experienced the
  562. problem, and your machine details, such as OS version, memory, hard discs and
  563. so forth.
  564.  
  565. Bugs and suggestions will be posted on the WWW site as often as possible.
  566. Unless stated, I assume that I can put your email address on the site, so
  567. that other users can ask you questions regarding the bug/suggestion. If you
  568. don't want this to happen, please state this clearly in the email.
  569.  
  570. Each bug and suggestion will be assigned a unique number which will help
  571. identify it - if you have any comments to make to an existing bug or
  572. suggestion, please reference it in the email. This will make tracking a lot
  573. easier.
  574.  
  575. --------------------------------  Open bugs  --------------------------------
  576.  
  577. Please visit the http://www.tribbeck.com/ web site, as it will be updated as
  578. regularly as possible with the latest bugs as reported from users. This site
  579. will also show the latest version that has been uploaded, and the UK time at
  580. which it was uploaded, so you can make sure that you have the latest version.
  581.  
  582. ------------------------------  Final copyright  ----------------------------
  583.  
  584. LongFilenames is © Jason Tribbeck/ARM Designs 1994-1998. All rights reserved.
  585.